home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / pc / files / t_unix / bs941029.tgz / bbsx-941029.tar / bbsx / admin.guide (.txt) next >
Amigaguide Document  |  1994-10-29  |  27KB  |  628 lines
  1. BBSX Version 1.5   ADMINISTRATIONGUIDE
  2. ======================================
  3. by: Thomas Fichte
  4.     dg1rtf@db0tud.deu.eu
  5.     fichte@freia.inf.tu-dresden.de
  6. 1. Einleitung
  7. -------------
  8. Die Konfiguration des BBSX und die Wartung seines Datenbestandes ist fuer
  9. den ordentlichen Betrieb unbedingt notwendig.
  10. Der Adminstrationsaufwand ist nicht besonders hoch und fast immer ohne
  11. UNIX-Kenntnisse moeglich. Das brachte mich auf die Idee einem User das Recht
  12. zu geben hier wirksam werden zu koennen, ohne ROOT-Rechte auf dem System zu
  13. besitzen. Fuer diese User, und auch fuer Administratoren die vom "dk5sg-bbs"
  14. auf das "bbsx" umsteigen ist dieses Manual geschrieben worden.
  15. 2. Installation des BBSX
  16. ------------------------
  17. Beim compilieren werden in ../lib die Dateien:
  18.   libutil.a
  19.   buildsaddr.h
  20.   strdup.h
  21. erwartet.
  22. Das Package kann mit "make" compiliert, mit "make install" installiert
  23. werden.
  24. 3. Administrationsdateien
  25. -------------------------
  26. 3.1. Einstellen der Standard-Parameter
  27. --------------------------------------
  28. Fuer das BBSX und alle Utility-Programme gibt es eine Konfigurationsdatei:
  29.   WRKDIR/config
  30. WRKDIR ist in "bbs.h" definiert und hat als Standard "/users/bbs".
  31. Das Format der Eintraege in "config" ist:
  32.   Parameter: Wert
  33. Zeile mit einem Hash (#) am Anfang gelten als Kommentar.
  34. Als Parameter sind folgende Werte moeglich:
  35. .IP cprg 17
  36. -Name des Programms, welches zur Kompression des
  37. BBS-Inhaltes verwendet wird. Zum Beispiel: "gzip"
  38. Default: compress
  39. .in 0
  40.   cextension     -  Die Extension, woran ein komprimiertes File erkannt
  41.                     wird. Zum Beispiel: ".gz"  fuer "gzip".
  42.                     Default: .Z
  43.   uncompressopt  -  Der hier angegeben Parameter wird zwischen den Namen des
  44.                     Kompressprogramms und den Filenamen fuer das
  45.                     Dekomprimieren kopiert.
  46.                     Ein Aufruf sieht dann z.B. so aus:
  47.                         gzip -d 00/00/00/01.gz
  48.                     Default: -d
  49.                     
  50.   compressopt    -  Fuer das Komprimieren, koennen bestimmte Optionen
  51.                     angegeben werden. Z.B. bewirkt "-9" beim "gzip" eine
  52.                     hoehere Komprimierung.
  53.                     Default:
  54.   bbsadm         -  Name des Nutzers, welcher beim BBSX mit dem Level "ROOT"
  55.                     eingelogged wird, bzw. die Utilites ausfuehren darf.
  56.                     Default: bbsadm
  57.   telluser       -  Name des Nutzers, welcher Nachrichten an T@THEBOX
  58.                     beantwortet.
  59.                     Default: tell
  60.   mydomain       -  Domain, mit der das BBSX sich nach aussen zeigt.
  61.                     Default: DEU.EU
  62.   myhostname     -  Hostname des Systems; der von gethostname() gelieferte
  63.                     Wert wird ueberschrieben.
  64.                     Default: gethostname()
  65.   logging        -  yes -> READ-Kommandos werden protokolliert
  66.                     no  -> kein Protokoll
  67.   debug          -  yes -> alle Kommandos werden in einem File
  68.                            /tmp/bbs.debug geloggt. Der Filename ist in
  69.                            bbs.h angegeben.
  70.                  -  no  -> kein Kommando-Logging
  71.   list           -  Anzahl der Eintraege im Indexfile, welche durchsucht
  72.                     werden.
  73.   fixaddress     -  yes -> address-rewriting ein
  74.                     no  -> address-rewriting aus
  75.   station        -  Stationsbeschreibung fuer den S&F-Header. Die
  76.                     Beschreibung muss mit "[" anfangen.
  77.                     Default: [WAMPES TEST-BBS XXXXXXXXXXXXXXXXXXX]
  78.   mbox           -  Loginname einer Mailbox, mit der S&F durchgefuert wird. Soll
  79.                     diese Box vom eigenen Host gepollt werden, so ist hier
  80.                     noch das Protokoll und das zu connectende Call (mit SSID)
  81.                     anzugeben.  Der Eintrag hat die Form:
  82.                          mbox: login_name
  83.                          mbox: login_name protokoll call
  84.                     Z.B.:
  85.                          mbox: db0tud
  86.                          mbox: db0jes ax25 db0jes-3
  87.   helpfile       - Name des Files mit Helptexten
  88.   infofile       - Name des Files mit Staionsbeschreibung
  89.   debugfile      - Filename fuer Debugoutput
  90.   mailfile       - enthaelt Usernamen, die grundsaetzlich als Mail geroutet
  91.                    werden.
  92. Beispiel:
  93. # Set the program, which you want to use to compress messages
  94. cprg: gzip
  95. # Set the extension, which is generally used from the compress-program
  96. cext: .gz
  97. # Option, which the compress program need to decompress
  98. uncompressopt: -d
  99. # Option, which the compress program need to work
  100. compressopt: -9
  101. # Username of the BBS-Administrator
  102. bbsadm: bbsadm
  103. # Name of the User, who response the tell-request
  104. telluser: tell
  105. # Domain of the System
  106. mydomain: #SAC.DEU.EU
  107. # Hostname:
  108. myhostname: dg1rtf
  109. # description of station
  110. station: [DG1RTF - WAMPES BBSX TEST]
  111. # switch on/off the writing of the logfile for reading messages
  112. logging: yes
  113. # switch debug mode off
  114. debug: no
  115. # configured store & forward
  116. mbox: db0sao
  117. mbox: db0tud ax25 db0tud
  118. mbox: oe9xpi ax25 oe9xpi
  119. 3.2. Indexfile
  120. --------------
  121. File: WRKDIR/index
  122. Das Indexfile enthaelt alle Informationen ueber Nachrichten im BBS. Es ist
  123. in binaerer Form und kann somit nicht gelesen werden. Das File wird schnell
  124. sehr gross und sollte mit den im Package enthaltenen Utilities
  125. gegebenenfalls gekuerzt werden. Die genaue Struktur des Files ist in bbs.h
  126. ersichtlich.
  127. 3.3. Bulletinidentifier
  128. -----------------------
  129. FILE: WRKDIR/seqbid
  130. Beim Einspielen einer Message durch einen User wird ein Bulletinidentifier
  131. vergeben, der die Form:  HOSTNAMEseqbid hat. Der Inhalt von "seqbid" wird
  132. nach der Einspielung um 1 erhoeht.
  133. Dieser Wert darf niemals veringert, oder das File geloescht werden!
  134. 3.4. Rubrikenaliase
  135. -------------------
  136. FILE: WRKDIR/bbsalias
  137. Zur Erhoehung der Uebersichlichkeit koennen Rubrikennamen beim Einspielen
  138. geaendert werden. Fuer das S&F bleibt die Originalrubrik erhalten.
  139. Fileformat:
  140.   wandeln_von   wandeln_nach
  141. Fuer Joker gilt UNIX-Filestyle.
  142. Ein "*" am Beginn der Zeile heisst: Jede Rubrik !!! Das darf nur am Ende 
  143. dieses Files stehen. Mit # beginnende Zeilen sind Kommentare.
  144. Ein dritter Parameter gilt als Kommentar.
  145. Beispiel:
  146. # Move LINUX TO UNIX
  147. linux    unix
  148. soft*    software
  149. *sat*    sat
  150. *       diverses
  151. 3.5. Sperren von Eintraegen
  152. ---------------------------
  153. Bestimmte Eintraege koennen fuer das Einspielen in das BBS gesperrt werden,
  154. bzw. fuer den S&F an einen angebenen Partner.
  155. Die Eintraege in:
  156.   WRKDIR/<hostname>.NO
  157. <hostname> ist der eigene Name, wenn das Einspielen verhindert werden soll,
  158. der Loginname der Partnerbox, falls kein S&F bestimmter Nachrichten erfolgen
  159. soll. Der Name fuer den eigenen Host wird durch gethostname() ermittelt und
  160. kann im "config"-File ueberschrieben werden.
  161. Die Files haben keinen Einfluss auf Mail!
  162. Fuer die Eintraege gilt UNIX-Filestyle. Ein dritter Parameter gilt als
  163. Kommentar.
  164. Fileformat:
  165.   Art Eintrag
  166. Art ist die Angabe, welcher Parameter im SEND Kommando ausgewertet werden
  167. soll. Gueltig sind die Zeichen: ><@. Eintrag ist der zu sperrende Begriff.
  168.   >  an eine Rubrik
  169.   <  von einem User
  170.   @  dieser Verteiler
  171. Beispiel:
  172.   # Nichts von DG1RTF
  173.   < dg1rtf
  174.   > musi*    # Keine Musik
  175.   > bilder    # Keine Bilder
  176.   # Keine Nachrichten an @THEBOX, @ALLE
  177.   @ THEBOX
  178.   @ ALLE
  179. 3.6. BBS-Hilfstexte
  180. -------------------
  181. File: WRKDIR/help
  182. In "help" stehen alle durch den User abrufbaren Help-Texte fuer die
  183. einzelnen Kommandos. Die Eintraege sind sequentiell im File angeordnet.
  184. "^<item>" mrkiert den Beginn des Blocks, der mit HELP <item> angefordert
  185. werden kann. Der Block endet beim naechsten ^<item> wenn sich dazwischen
  186. wenigsten eine Zeile befindet, die nicht mit "^" beginnt.
  187. Beispiel:
  188. ^help
  189. Helptext fuer Hilfe
  190. ^naechter_hilfstext
  191. 3.7. BBS-"Message of the day"
  192. -----------------------------
  193. FILE: WRKDIR/.welcome
  194. Beim Start des BBS durch Nutzer wird, wenn vorhanden, der Inhalt dieser
  195. Datei angezeigt.
  196. 3.8. Lifetimeverwaltung
  197. -----------------------
  198. FILE: WRKDIR/lifetime
  199. Dieses File enthaelt die Lifetimes der einzelnen Rubriken. Es wird nicht vom
  200. BBSX ausgewertet, sondern durch das Utility "life".
  201. Die Jokerzeichen *,? sind erlaubt.
  202. Der Defaultwert fuer Rubriken, welche nicht in diesem File erfasst sind ist
  203. 15 Tage. Er kann ueberschrieben werden, durch die Angabe einer Lifetime fuer
  204. eine Pseudo-Rubrik: "other" oder einen "*" als ersten Zeichen in der Zeile.
  205. Lifetime = -1 bedeuted sofort loeschen.
  206. Lifetime =  0 Rubrik hat unendliche Lifetime
  207. Die Lifetime wird in Tagen angegeben.
  208. Format:
  209.    Rubrik Lifetime
  210. Beispiel:
  211. tcpip 100
  212. unix 0
  213. other -1
  214. Siehe auch Utility "life" (11.6.).
  215. 3.9. Die globale Startup-Datei
  216. ------------------------------
  217. File: /usr/local/bin/bbsrc
  218. Der Inhalt dieser Datei wird beim Start des BBS von jedem Nutzer (auser
  219. Mailboxen) beim Start ausgfuehrt. Ein SET interface=diebox sollte hier nicht
  220. drin stehen. Es ist keine "DieBox" ! und daran sollen sich die Nutzer auch
  221. gewoehnen.
  222. 3.10. Stationsbeschreibung
  223. --------------------------
  224. File: /usr/local/lib/station.data
  225. Hier stehen die beim INFO Kommando angezeigten Informationen.
  226. 4. Zusaetzliche Kommandos im BBS
  227. --------------------------------
  228. 4.1. Das DESTROY Kommando
  229. -------------------------
  230. Das DESTROY Kommando wird zum physischen Loeschen von Nachrichten verwendet.
  231. Es kann danach kein UNDELETE Kommando mehr durchgefuehrt werden.
  232. Syntax:
  233.    DESTROY mesg# ...
  234. Beispiel:
  235.    DESTROY 12345
  236. 4.2. Das F Kommando (nur fuer S&F)
  237. ----------------------------------
  238. Mit dem F Kommando erfolgt die Umkehrung des Store und Forward.
  239. Das heisst, wenn der S&F-Partner seine Queue geleert hat, wird er dieses
  240. Kommando geben um fuer anstehende Nachrichten abzufordern.
  241. Syntax:
  242. 4.3. Das HIDE Kommando
  243. ----------------------
  244. Mit dem HIDE Kommando koennen Nachrichten in die Rubrik "A" bewegt werden.
  245. Das ist sinnvoll, wenn man Nachrichten vor dem allgeinem Zugriff schuetzen
  246. will, sie aber nicht geloescht werden sollen.
  247. Die Rubrik "A" sollte einen entsprechenden Lifetimeeintrag bekommen.
  248. Die hier stehen Bulletins werden nicht geforwardet.
  249. Syntax:
  250.   HIDE mesg# ...
  251. Beispiel:
  252.   HIDE 12345 23456
  253. 4.4. Das XCRUNCH Kommando
  254. -------------------------
  255. Das XCRUNCH Kommando kuerzt das Indexfile. Es werden nur Eintraege erhalten,
  256. die maximal 90 Tage alt sind und einen gueltigen BID besitzen. Die Anzahl 
  257. der zu loeschen Eintraege wird beim STATUS Kommando angezeigt.
  258. Syntax:
  259.   XCRUNCH
  260. Nach Ausfuehrung von XCRUNCH terminiert das BBS.
  261. Es kann Probleme mit anderen Utilities geben!
  262. 4.5. Das XSCREEN Kommando
  263. -------------------------
  264. Das XSCREEN Kommando dient dem Bearbeiten von Nachrichten an einem Terminal.
  265. Beim Aufruf von XSCREEN wird die erste verfuegbare Nachricht angezeigt.
  266. Dann sind folgende Kommandos moeglich:
  267.       <          Suche nach Message mit passendem FROM-Feld
  268.       <number>   Zeige die Nachricht, mit dieser Nummer
  269.       >          Suche nach Message mit passendem TO-Feld
  270.       ?          Zeigt Kommandouebersicht
  271.       @          Naechste Nachricht mit angebenem Verteiler
  272.       BACKSPACE  vorherigen passenden Eintrag zeigen
  273.       RETURN     naechsten passenden Eintrag zeigen
  274.       SPACE      naechste Bildschirmseite anzeigen
  275.       k          angegeben Eintrag loeschen (physisch)
  276.       q          Bildschirmmodus verlassen
  277.       r          aktuellen Eintrag nochmal anzeigen
  278.       s          Suche nach angebenen Subject
  279.       v          Nachricht editieren. Es wird das mit: set editor
  280.                  spezifierte Programm verwendet.
  281. 4.6. Das CHANGE Kommando
  282. ------------------------
  283. Das CHANGE-Kommando dient dem Aendern der Indexfileeintraege aus dem
  284. BBS heraus.
  285. Syntax:  change field msg# ...
  286.        Fuer "field" sind moeglich:
  287.             lifetime, #
  288.             to,       >
  289.             at,       @
  290.             from,     <
  291.             bid,      $
  292.             subject
  293. Beispiele:
  294.        bbsx> change # 17
  295.        Message #17 Lifetime [10] : 5
  296.        bbsx> change # 17
  297.        Message #17 Lifetime [5] : expired
  298. 5. Sonderrechte
  299. ---------------
  300. Grundsaetzlich darf ein mit dem Level gleich ROOT eingeloggter User alles.
  301. Fuer die Kommandos:
  302.   DELETE, MAIL, MOVE, UNDELETE
  303. bestehen keine Restriktionen. Es koennen alle Nachrichten bearbeitet werden,
  304. unabhaengig vom Einspieler der Message.
  305. Es besteht Zugriff auf alle Rubriken, auch die, deren Name aus einem Zeichen
  306. besteht. Das sind:
  307.   A - Archivrubrik
  308.   B - Backuprubrik
  309.   E - Ferneraseinformationen
  310.   M - MYBBS-Information
  311.   T - Tellanforderungen
  312. Die Rubriken E, M und T benoetigen als Verteiler unbedingt @THEBOX.
  313. Bei einem LIST Befehl fuer diese Rubriken ist der TO Parameter anzugeben.
  314. Beispiel:
  315.   LIST > A COUNT 5       Listet die letzten 5 Messages an A
  316. 6. BBS - Modes
  317. --------------
  318. Das BBS ist in verschiedenen Modi aufrufbar. Dazu werden koennen beim Start
  319. verschiedene Optionen angegeben werden.
  320.    -d        DEBUG-Modus:
  321.                 alle Kommandos der gestarteten BBS werden in /tmp/bbs.debug
  322.                 gelogged. Siehe auch 3.1. !
  323.    -m        MAIL oder NEWS Modus:
  324.                 Das BBS erwartet die Mail oder das Bulletin mit
  325.                 RFC822-Header. Das BBS ist dann aehnlich rnews, rmail
  326.                 benutzbar.
  327.                    
  328.    -f <bbs>  S&F-Modus:    
  329.                 Es wird eine S&F-Verbindung zum angegeben bbs aufgebaut. Das 
  330.                 Uebertragungsprotokoll und die zu connectende Hardwareadresse 
  331.                 muessen bekannt sein. (siehe 3.1.)
  332.    -w <seconds> Warteschleife:
  333.                 Das BBS wartet die angegebenen Sekunden bis es startet.
  334.                 Damit kann das Programm in die /etc/inittab eingetragen
  335.                 werden  und ein S&F gesteuert werden.
  336.            
  337.                 Beispiel:
  338.            sf:6:respawn:/usr/local/bin/bbs -w 3600 -f db0jes >/dev/null        
  339. 7. Store und Forward
  340. --------------------
  341. Das BBSX simuliert DieBox Version 1.8.
  342. S&F -Partner werden in WRKDIR/config eingetragen (siehe 3.1.).
  343. Ein Eintrag:
  344.   mbox: <call>
  345. bewirkt, dass sich das BBS beim Start durch <call> mit einem fuer den S&F
  346. benoegtigten Prompt meldet.
  347. Um das BBS automatisch zu starten, muessen in der .profile/.login des <call>
  348. folgende Eintraege vorhanden sein:
  349. mesg no
  350. stty intr '^-' quit '^-' erase '^-' kill '^-' eof '^-' eol '^-' swtch '^-'
  351. -brkint -isig
  352. exec bbs
  353. In der ".bbsseq" steht die Messagenummer der letzten geschickten Nachricht.
  354. Etwaige Loginmeldungen in /etc/profile duerfen nicht an einen S&F-Partner
  355. gegeben werden. Baycom reagiert da sehr empfindlich.
  356. Soll ein anderes BBS durch das eigene gepollt werden um S&F durchzufuehren,
  357. sind die entsprechenden Routingeintraege in der "net"-Konfiguration
  358. sicherzustellen.
  359. In WRKDIR/config muss zusaetzlich zum <call> noch das Uebertragungsprotokoll
  360. und die Hardwareadresse angeben werden:
  361.   mbox: <call> <proto> <adress>
  362. Das Pollen eines S&F-Partners erfolgt mittels "-f" Option des BBS.
  363. Entsprechende Eintraege sind in der "crontab" der "root" oder des
  364. BBS-Administrators anzulegen.
  365. Wird der BBS Aufruf ueber die /etc/inittab geregelt, kann mittels "-w"
  366. Option der Start des Programms verzoegert werden (siehe 6.).
  367. 8. Kompatibilitaet
  368. --------------------
  369. BBSX wertet den System Identifier aus.
  370. Es kennt momentan folgende Systeme: DieBox Baycom
  371. Folgendes Verhalten ist realisiert.
  372. +------------------------+-----------------+-------------------+
  373. |                        |  DieBox         |  Baycom           |
  374. |                        |  1.7  1.8  >>>  |  1.13  1.14  >>>  |
  375. +------------------------+-----------------+-------------------|
  376. | Subject in Message-    |   O    X    X   |    O    X     X   |
  377. | header fuer E/M@THEBOX |                 |                   |
  378. +------------------------+-----------------+-------------------+
  379. | S&F-Beschleunigung     |   O    O    x   |    O    O     O   |
  380. | fuer E/M@THEBOX        |                 |                   |
  381. +------------------------+-----------------+-------------------+
  382. | BOXBIN                 |   O    O    x   |    O    O     O   |
  383. +------------------------+-----------------+-------------------+
  384. Die im System-Identifier angegebenen Flags werden nicht ausgewertet.
  385. Das BBS selbst gibt nur das H-Flag nach Aussen.
  386. 9. Fernerase
  387. ------------
  388. Ein netzweiter Fernerase wird ausgeloest, wenn ein Nutzer seine Nachrichten
  389. mittels DELETE Kommando loescht. Diese Funktion tritt nur dann in Kraft,
  390. wenn der Verteiler ungleich dem eigenen Hostnamen ist.
  391. Eingeloggte User mit einem Level gleich "ROOT" loesen mit einem DELETE
  392. Kommando keinen Fernerase aus. Sie muessen dies explizit mit einem SEND
  393. Kommando an: E@THEBOX tun.
  394. Zum Beispiel:
  395.   S E @ THEBOX < DB0TUD 
  396. Subject:
  397.   BID_der_zu_loeschenden_Nachricht
  398. Von anderen BBS ausloeste Fernerase werden durch das Utility "rerase"
  399. bearbeitet.
  400. 10. Setzen der MYBBS-Information
  401. --------------------------------
  402. Mit dem Kommando MYBBS erzeugt der Nutzer eine Nachricht an M@THEBOX.
  403. Ein entsprechender SEND Befehl wuerde so aussehen:
  404.   S M @ THEBOX < USER
  405. Subject:
  406.   MYBBS time     ^Z         time in Unixsystemzeit
  407. Zum Update der Userdatabase muss das  mitgelieferte Utility "udbm" verwendet
  408. werden. Jenes in der Originaldistribution erzeugt ein Chaos, da die Struktur
  409. des Indexfile geaendert wurde.
  410. Das udbm sollte 1-2 mal taeglich gestartet werden. Dazu sind entsprechende
  411. Eintraege in der crontab des ROOT-Users vorzunehmen.
  412. 11. Dienstprogramme
  413. -------------------
  414. 11.1. BBSCOMPR
  415. --------------
  416. BBSCOMPR dient dem Scannen des Indexfiles auf alte Eintraege und
  417. komprimieren der dazugehoerigen Nachricht.
  418. Syntax:
  419.   bbscompr [-t time]
  420. Optionen:
  421.   -t <time>          Nachrichten, die laenger als <time> (in Tagen) sich im
  422.                      BBS befinden werden komprimiert.
  423. BBSCOMPR benutzt einen im System vorhandenes Komprimierprogramm. Er wird im
  424. "config"-File festgelegt. Ebenso die fuer dieses Programm typische
  425. Fileendung und Optionen, die fuer das Komprimieren und Dekomprimieren
  426. benoetigt werden (siehe 3.1).
  427. Alle Dienstprogramme, die auf Nachrichten zugreifen, versuchen
  428. zuerst ein Nachrichtenfile zu oeffnen, welches aus der durch die
  429. Messagenummer gebildeten Namen plus der, fuer den Komprimierer
  430. typischen Filenamenerweiterung besteht. Sollte also irgendwann mal das
  431. Komprimierprogramm gewechselt werden, muessen alle Nachrichten vorher
  432. entpackt werden, da getfilename() sonst mit einer Fehlermeldung terminiert.
  433. Die Defaultwerte sind auf "compress" ausgelegt. Ich empfehle aber "gzip" zu
  434. verwenden.
  435. Wird die Nachricht durch einen Nutzer gelesen, wird diese vorher
  436. dekomprimiert und verbleibt bis zum naechsten Start von "bbscomp" in diesem
  437. Zustand.
  438. Soll das Programm durch einen BBS-Administrator genutzt werden, so muss das
  439. Programm dem ROOT-User gehoeren und dieser ein suid-Bit setzten. "bbscompr" 
  440. terminiert beim Start, wenn es nicht durch den ROOT-User oder den im
  441. "config"-File angegeben BBS-Administrator aufgerufen wird.
  442. Files:
  443.   /usr/local/etc/bbscompr
  444. 11.2. BBSRENUM
  445. --------------
  446. Mit BBSRENUM kann das BBS umnummeriert werden. Es werden dabei alle
  447. Eintraege im Indexfile bearbeitet, jede .bbsseq aktualisiert und die
  448. Filenamen der Nachrichten geaendert. 
  449. Das das nicht bei laufenden Mailboxbetrieb geschehen kann, ist einzusehen.
  450. Es wird fuer das Umnummerieren ein Protokollfile geschrieben: renum.proto
  451. und das Originalindexfile in "index.o" umbenannt.
  452. Es ist sicherzustellen, dass das Programm waehrend der Abarbeitung nicht
  453. unterbrochen wird.
  454. Files:
  455.   /usr/local/etc/bbsrenum
  456.   /users/bbs/renum.proto
  457. 11.3. CONVIND
  458. -------------
  459. Zur Konvertierung des Indexfile des DK5SG-BBS in das BBSX Format wird
  460. CONVIND benoetigt.
  461. Syntax:
  462.   convind
  463. Files:
  464.   convind
  465. 11.4. FINDPATH
  466. --------------
  467. "findpath" erstellt eine Liste von S&F-Wegen.
  468. Syntax:
  469.   findpath
  470. Dazu werden die "R:"-Zeilen aller Nachrichten seit dem letzten "findpath"
  471. ausgewertet. Die Liste hat folgendes Format:
  472.   mbox nachbar1 date   
  473.   mbox nachbar2 date
  474. Date gibt die Zeit der letzten Benutzung der S&F-Route an und steht in
  475. UNIX-Systemzeit. Die Ausgabe erfolgt nach: "findpath_data". Auf die
  476. Standardausgabe wird eine aehnliche Liste geschrieben. Diese betrifft aber
  477. den gesamten Datenbestand, ist ungeordnet und gibt anstelle des Datums einen
  478. Wert aus, der eine Aussage ueber die letzte Benutzung des Weges macht.
  479. Eine hohe Zahl bedeutet: lange nichts mehr ueber diesen Weg gegangen.
  480. Mit diesen Listen ist es moeglich sich eine UUCP-Konfiguration zu
  481. generieren.
  482. Zur Auswertung muessen allerdings alle Nachrichten entkomprimiert werden.
  483. Eine gleichzeitige Anwendung von "findpath" und "bbscompr" scheint deshalb
  484. nicht sinnvoll.
  485. Eine Benutzung durch den BBS-Administrator ist mit den unter 11.1.
  486. angegebenen Bedingungen moeglich.
  487. Files:
  488.   /usr/local/etc/findpath
  489.   /users/bbs/findpath_data
  490.   /usr/lib/uucp/paths
  491. 11.5. KILLDUP
  492. -------------
  493. Mit dem "killdup"-Programm werden Nachrichten gleichen
  494. Inhalts geloescht, wenn sie laenger als eine Woche im BBS gespeichert sind.
  495. Syntax:
  496.   killdup
  497. Da Messages an E@THEBOX und M@THEBOX keinen, also den gleichen Messageinhalt
  498. haben, werden diese Rubriken geloescht.
  499. Auch hier besteht das Problem, dass alle Nachrichten dekomprimiert werden
  500. muessen. Ein gleichzeitige Verwendung mit "bbscomp" erscheint nicht
  501. sinnvoll.
  502. Eine Benutzung durch den BBS-Administrator ist mit den unter 11.1.
  503. angegebenen Bedingungen moeglich.
  504. Files:
  505.   /usr/local/etc/killdup
  506.   /users/bbs/killdup_data
  507. 11.6. LIFE
  508. ----------
  509. Zur Auswertung von /users/bbs/lifetime wird das Programm "life" benoetigt.
  510. Syntax:
  511.   life
  512. Dieses Programm vergleicht die in /users/bbs/lifetime angegeben Eintraege
  513. mit jeder Nachricht. Ist diese laenger als im File angegeben wird die
  514. Nachricht in die Rubrik "B" bewegt. War die Nachricht schon in "B", wird sie
  515. physisch geloescht.
  516. Weiterhin werden die durch die User angegeben Message-Lifetimes ausgewertet. 
  517. Es hat immer die kuerze Lifetime hoehere Prioritaet.
  518. Die Struktur des Files /users/bbs/lifetime ist unter 3.8. beschrieben.
  519. Nochmals sei darauf hingewiesen, dass Liftime=0 unendlich bedeuted und die
  520. Standardlifetime fuer nicht aufgefuehrte Rubriken 15 Tage ist. Sie kann mit
  521. einem Eintrag fuer die Rubrik "other" ueberschrieben werden.
  522. Die Lifetimeverwaltung sollte einmal taeglich erfolgen und durch einen
  523. cronjob gesteuert werden.
  524. Bei der Bearbeitung durch "life" wird der Verteiler der Nachricht
  525. grundsaetzlich auf den eigenen Hostnamen gesetzt. Damit ist gewaehrleistet,
  526. dass kein S&F mehr fuer diese Nachricht erfolgt.
  527. Eine Benutzung durch den BBS-Administrator ist mit den unter 11.1.
  528. angegebenen Bedingungen moeglich.
  529. Files:
  530.   /usr/local/etc/life
  531.   /users/bbs/lifetime
  532. 11.7. RERASE
  533. ------------
  534. Mit "rerase" wird die Rubrik E@THEBOX ausgewertet. In E@THEBOX stehen die
  535. Informationen zum Fernerase (siehe 9.)
  536. Syntax:
  537.   rerase [-d]  [-a|b|r dest.] [-t]
  538. Optionen:
  539.     -d        debug
  540.     -a        Nicht loeschen, sondern Nachricht nach Rubrik "A"
  541.     -b        Nicht loeschen, sondern Nachricht nach Rubrik "B"
  542.     -r dest   Nicht loeschen, sondern Nachricht nach Rubrik <dest>
  543.     -t        Timestamp nicht aktualisieren
  544. Fuer den Fall, das nicht geloescht werden soll, wird der Original-Verteiler
  545. duch den eigenen Hostnamen ersetzt.
  546. Die Aktualisierung des Timestamp (Standardeinstellung) sollte eingeschalten
  547. bleiben, wenn eine Lifetimeauswertung installiert ist.
  548. Der Eintrag an E@THEBOX bleibt erhalten. Die Rubrik "E" muss entweder mit
  549. "life" oder "killdup" geloescht werden.
  550. Eine Benutzung durch den BBS-Administrator ist mit den unter 11.1.
  551. angegebenen Bedingungen moeglich.
  552. Files:
  553.   /usr/local/etc/rerase
  554. 11.8. SFSTAT
  555. ------------
  556. Das Programm "sfstat" zeigt die noch in der Forwardqueue stehenden Eintraege
  557. fuer einen S&F-Partner. Dabei wird nur die Differenz zwischen hoechster
  558. Messagenummer und letzter geforwardeter Message angezeigt. Dieser Wert ist
  559. nur fuer Uebrsichtszwecke zu gebrauchen.
  560. "sfstat" zeigt nur dann ein Ergebnis, wenn fuer den S&F-Partner ein File:
  561. ".bbsseq" existiert.
  562. Files:
  563.   /usr/local/bin/sfstat
  564.   $HOME/.bbsseq
  565. 11.9. TELL
  566. ----------
  567. "tell" wird benutzt um eingegangene "tell-responses" auszuwerten. Sie stehen
  568. in der Rubrik "T".
  569. Syntax:
  570.   tell
  571. "tell" muss unbedingt durch den User "ROOT" gestartet werden. Weiterhin muss
  572. ein "telluser" im Config-File definiert sein. Der Tell-Response wird mit den
  573. Rechten dieses Users ausgefuehrt. Das heisst er muss exitieren und einen UID
  574. unterschiedlich 0 und des BBS-Administrators haben. Die Standardeinstellung
  575. ist "tell" (siehe auch 3.1.)
  576. Das Ergebnis der Bearbeitung wird als Mail an den Absender geschickt.
  577. Files:
  578.   /usr/local/etc/tell
  579.   /etc/passwd
  580. 11.10. TRANSFER
  581. ---------------
  582. Zum Loeschen oder Verschieben ganzer Rubriken wird "transfer" verwendet.
  583. Syntax: 
  584.   transfer [-a] [-t] [-d] source [destination]
  585. Optionen:
  586.   -a  Verteiler wird auf den eigenen Hostnamen gesetzt
  587.   -t  timestamp wird auf aktuelle Zeit gesetzt
  588.   -d  die bei angegebene Rubrik wird geloescht.
  589. Eine Benutzung durch den BBS-Administrator ist mit den unter 11.1.
  590. angegebenen Bedingungen moeglich.
  591. Beispiele:
  592.   transfer -d meinung       Rubrik MEINUNG wird geloescht
  593.   transfer meinung b        Rubrik MEINUNG wird in die Backuprubrik bewegt
  594.   transfer -a -t meinung b  es wird zusetzlich die Zeiteintrag geaendert
  595.                             (fuer Lifetime) und der Verteiler so gesetzt,
  596.                             dass kein S&F mehr moeglich ist.
  597. Files:
  598.   /usr/local/etc/transfer
  599. 11.11. UDBM
  600. -----------
  601. Der UserDataBaseManager wurde von dk5sg ohne Aenderungen uebernommen. Er
  602. muss nur neu compiliert werden, da die Strukturen der Indexfiles nicht
  603. uebereinstimmen. Eine Beschreibung der Funktionsweise des "udbm" bleibt
  604. dk5sg vorbehalten.
  605. Files:
  606.   /usr/local/etc/udbm
  607. A - Files
  608. ---------
  609. .bbsrc                        persoenliche Startupdatei
  610. .bbsseq                       Nummer der letzten gelisteten Nachricht
  611. /users/bbs/.welcome           Begruessungsmessage
  612. /users/bbs/<hostname>.NO      gesperrte Eintraege fuer <hostname>
  613. /users/bbs/??/??/??/??        Bulletins
  614. /users/bbs/bbsalias           Aliase in die Rubriken gemoved werden
  615. /users/bbs/config             Konfigurationsfile
  616. /users/bbs/findpath_data      Liste mit S&F-Wegen
  617. /users/bbs/help               Helptexte
  618. /users/bbs/index              Indexfile
  619. /users/bbs/lifetime           Lifetime der einzelnen Rubriken
  620. /users/bbs/lock               programmintern
  621. /users/bbs/readlog            Protokoll aller READ Kommandos
  622. /users/bbs/renum.proto        Protokoll fuer renumber-utility
  623. /users/bbs/seqbid             enthaelt letzte vergebene BID
  624. /users/bbs/bid.dir            BID-Database-Files
  625. /users/bbs/bid.pag
  626. /usr/local/lib/bbsrc          globale Startupdatei
  627. /usr/local/lib/station.data   Stationsbeschreibung
  628.